home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 035a / slvchn10.zip / SOLVECHN.DOC < prev   
Text File  |  1993-03-29  |  8KB  |  157 lines
  1. Documentation for SolveCHN version 1.4
  2. --------------------------------------
  3.  
  4. SolveCHN is distributed as shareware.  You are authorized to evaluate this
  5. program for thirty (30) days in order to determine whether it is suitable for
  6. your needs.  After this, you are required to submit a registration fee of $20
  7. US for a single user.  Corporations may want to consider a site license for
  8. $250 US.  Registered users will receive the latest version and point release
  9. upgrades free of charge.
  10.  
  11. Registration fees may be sent to:       Coments, suggestions for new features
  12. Andrew Williams                          and bug reports (!?) may be sent by
  13. 5 Research Parkway                            mail to the address shown,
  14. Wallingford, CT   06492                      CIS 70724, 3556 or Internet:
  15.                          williamsa@delphi.com
  16.  
  17.         (Previous versions were not available to the public.)
  18.  
  19.  
  20. Operating Environments
  21. ----------------------
  22.  
  23. SolveCHN, in its various versions (see below), is compiled as a text-based DOS
  24. application for the IBM PC and compatible computers in order to allow the
  25. largest number of users to take advantage of it.  It has been tested under
  26. OS/2 2.0 as a DOS application in both full screen and windowed DOS sessions.
  27. It has also been tested as a DOS application running under Microsoft Windows
  28. 3.0/3.1 in standard mode as a full screen DOS application and in enhanced mode
  29. as a full screen or windowed DOS application.  It behaves well under any of 
  30. these enviroments.  In fact it will run in as little as 128k of RAM under DOS,
  31. OS/2 2.0 or Microsoft Windows.
  32.  
  33.  
  34. General Instructions
  35. --------------------
  36.  
  37. SolveCHN is designed to automate the tedious process of figuring out the
  38. composition of a freebase / salt / solvate combination.  Traditionally this
  39. has been done by manually plugging values into a spreadsheet or other number 
  40. cruncher, viewing the results and adjusting accordingly until a solution is 
  41. found.
  42.  
  43. SolveCHN removes the drudgery from this process by asking for some simple
  44. parameters:
  45.  
  46.     Base:               The empirical formula of the freebase
  47.     Salt:               The empirical formula of the salt
  48.     Solvate:            The empirical formula of the solvate
  49.  
  50.     Note when entering formulas that if there is only one atom of any
  51.     particular type this must be specified.  Thus the formula C12H23N3O1 
  52.     is accepted while C12H23N3O will generate an error.  Upper and/or
  53.     lower case is accepted.  **THE TOTAL NUMBER OF ANY GIVEN ATOM MUST BE
  54.     SUMMED.**  For example, C2H5O1H1 as the formula for ethanol will
  55.     generate erroneous results.  It should be entered as C2H6O1.
  56.  
  57.     Experimental %C:    The %C found by combustion analysis
  58.     Experimental %H:    The %H found by combustion analysis
  59.     Experimental %N:    The %N found by combustion analysis
  60.  
  61.     The upper limit for the 'salt factor':
  62.         The maximum amount of the salt (acid) component to be
  63.         considered.
  64.     The upper limit for the 'solvate factor':
  65.         The maximum amount of the solvate component to be considered.
  66.     The lower limit for the 'salt factor':
  67.         The minimum amount of the salt component to be considered.
  68.     The lower limit for the 'solvate factor':
  69.         The minimum amount of the solvate component to be considered.
  70.     The accuracy desired:
  71.         Traditionally, 0.4% has been regarded as proof of elemental
  72.         composition.  If a solution is found with this accuracy
  73.         requirement, a better solution may be found with a more
  74.         stringent requirement for accuracy.
  75.  
  76. SolveCHN was designed for organic substrates, and does not support transition
  77. metals, lanthanides, actinides, etc. as valid atoms.  This will be changed in
  78. a "soon to be released" version so that all atoms are recognized.  To be 
  79. explicit, the following atoms are currently supported:
  80.  
  81.     Carbon      Oxygen    Fluorine    Lithium      Silicon
  82.     Hydrogen    Sulfur    Chlorine    Sodium       Phosphorous
  83.     Nitrogen              Bromine     Potassium    Selenium
  84.                   Iodine      Calcium
  85.  
  86. After these parameters are entered, the program begins to test all possible
  87. salt and solvate combinations in a methodical fashion until the accuracy
  88. requirements are met, or until the upper limits are reached.  This can take a
  89. minute or two depending upon several factors:
  90.  
  91.     1) most importantly, the speed of your microprocessor
  92.     2) the version of the program you are running and the presence of a
  93.        math coprocessor (see below)
  94.     3) the upper limits themselves
  95.  
  96. While these somewhat time-consuming calculations are taking place, a mistake
  97. in input might be recognized.  Accordingly, it is possible to abort the
  98. calculations by pressing any key while they are proceeding.  A message
  99. indicating that the calculations were interrupted is shown.  The options to
  100. edit the existing entries, enter a new entry or quit the program are then
  101. presented.  These options are also available when a solution is found or the
  102. upper limits are reached.
  103.  
  104. Editing the existing (or brand new) entries is designed to be as easy as
  105. possible.  The editing function is in 'insert' mode by default; that is, a
  106. character is inserted into the formula at the cursor position without 
  107. disrupting the rest of the formula or number.  The standard left, right, up
  108. and down arrow, home, end, delete, tab and backspace keys are implemented.
  109. The F1 key brings up context-sensitive help while entering or editing an
  110. entry.  The F9 key causes the program to jump to the calculation phase using
  111. the existing entries.  For example, if no solution is found on the first try
  112. and a mistake in input is recognized, only the incorrect entry need be
  113. modified.  Pressing the F9 key then proceeds immediately to the calculation
  114. phase.  In addition, the ESCape key will abort the program while editing any
  115. entry.
  116.  
  117. SolveCHN was designed to be small, fast and unobtrusive.  This is one reason
  118. that it does not change your DOS screen colors or use a graphical interface.
  119. Presently, SolveCHN does not attempt to globally optimize the salt / solvate
  120. combination for accuracy.  This provides the fastest possible feedback on
  121. whether a 'hit' will be found.  Future revisions may include this feature
  122. depending upon user demand.  Porting SolveCHN to enviroments other than DOS
  123. is under consideration.
  124.  
  125.  
  126. Main Processor and Math Coprocessor Support
  127. -------------------------------------------
  128.  
  129. The SLVCHN.ZIP file should contain the files noted in the CONTENTS.TXT
  130. file.  If it does not, contact the sysop of the BBS where you obtained the
  131. file or contact the author on CompuServe: 70724,3556.
  132.  
  133. SolveCHN is designed to run on all IBM-compatible personal computers, from
  134. those based on the 8088 to i486 microprocessors.  SolveCHN uses extensive
  135. floating-point mathematics.  SOLVECHN.EXE can emulate an 80x87 math 
  136. coprocessor in software, but this causes slower execution and necessitates a
  137. larger file size for the executable.  Personally, I like maximum performance
  138. at minimal hard drive space, so there are several versions of the program
  139. included.  To obtain optimal performance, you should use the version designed
  140. for your machine as shown below:
  141.  
  142.      For 8088 or 8086 machines with no math coprocessor, rename
  143.      SOLVECHN.086 to SOLVECHN.EXE and type SOLVECHN to run the program.
  144.  
  145.      For 8088 or 8086 machines with an 8087 math coprocessor, rename
  146.      SOLVECHN.087 to SOLVECHN.EXE and type SOLVECHN to run the program.
  147.  
  148.      For 80286 or higher machines with no math coprocessor, rename 
  149.      SOLVECHN.286 to SOLVECHN.EXE and type SOLVECHN to run the program.
  150.  
  151.      For 80286 or higher machines with an 80287 or higher math 
  152.      coprocessor, rename SOLVECHN.287 to SOLVECHN.EXE and type SOLVECHN 
  153.      to run the program.
  154.  
  155. Note:    i486SX based systems do not have a math coprocessor unless they have
  156.      been upgraded.  i486DX systems have an integrated math coprocessor.
  157.